home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 July / Amiga Games 1996 #7.iso / userbox / publicdomain / chunker / chunker.doc < prev    next >
Text File  |  1996-04-02  |  11KB  |  306 lines
  1.       ______________      ______________
  2.      /             /     /_/_/_/_/_/_/_/   Chunker 1.6 <--> DeChunk 1.6
  3.     /             /     /_/_/_/_/_/_/_/
  4.    /             /     /_/_/_/_/_/_/_/     A portable method of splitting
  5.   /             / <-> /_/_/_/_/_/_/_/      and joining files.
  6.  /             /     /_/_/_/_/_/_/_/
  7. /_____________/     /_/_/_/_/_/_/_/        Copyright ©1996 Lee Kindness.
  8.  
  9.  
  10. Chunker:
  11. Compiled           Monday 01 April 1996 18:41:07
  12. Amiga Exe size     4428 bytes
  13. Amiga 1.3 size     9776 bytes
  14. MSDOS Exe size     15458 bytes
  15. Version            Chunker 1.6 (01/04/96)
  16.  
  17. DeChunk:
  18. Compiled           Monday 01 April 1996 18:40:52
  19. Amiga Exe size     4304 bytes
  20. Amiga 1.3 size     9676 bytes
  21. MSDOS Exe size     15229 bytes
  22. Version            DeChunk 1.6 (01/04/96)
  23.  
  24. Distribution built Tuesday 02 April 1996 12:13:01
  25.  
  26.  
  27.  LEGAL
  28. -=====-
  29.  
  30.  Disclaimer
  31.  ~~~~~~~~~~
  32.  I hereby reject any liability or responsibility for these or any
  33.  other consequences from the use of Chunker whatsoever. This includes,
  34.  but is not limited to, damage to your equipment, to your data,
  35.  personal injuries, financial loss or any other kinds of side effects.
  36.  Although Chunker has been tested thoroughly on several different
  37.  machines, I cannot rule out the possibility that Chunker:
  38.  
  39.      1. is somehow incompatible to your equipment
  40.      
  41.      2. has bugs that show up on your equipment
  42.      
  43.      3. does not do what it is supposed to do on your equipment
  44.      
  45.      4. May damage you equipment
  46.  
  47.  It is your responsibility to take any precautions necessary to
  48.  protect yourself from these or any other effects. I explicitly
  49.  reject any liability or responsibility from the consequences of you
  50.  using Chunker
  51.  
  52.  Distribution
  53.  ~~~~~~~~~~~~
  54.  
  55.  Chunker may be freely distributed and copied, as long as the following 
  56.  conditions are fulfilled:
  57.  
  58.      1. All parts of the program and the documentation must be complete.
  59.         The distribution of single parts or incomplete subsets of the
  60.         original distribution is forbidden.
  61.         
  62.      2. If Chunker is to be included in a commercial distribution (including
  63.         magazines!) then I must be sent a copy of the product (or if it is a 
  64.         mag that I am subscribed to then an increase in subscription). It 
  65.         would be better if you contacted me beforehand to ensure you have the 
  66.         latest version. In any case full credit must be given within the
  67.         magazine (ie mention my name).
  68.      
  69.      3. If the included source code is used in another program then credit 
  70.         must be given in the documentation.
  71.  
  72.  Note To Magazines
  73.  ~~~~~~~~~~~~~~~~~
  74.  
  75.  In the past I have had some of my programs included on magazine coverdisks
  76.  without my permission when in the documentation it was stated that this
  77.  was required... I want my programs on coverdisks but you _MUST_ read and
  78.  fufil the "Distribution" section above. If you disagree then contact me
  79.  or write a message in the AMIGA_MAGS echo...
  80.  
  81.  
  82.  COMPILATION
  83. -===========-
  84.  
  85.  This archive includes versions of Chunker and DeChunk for the Amiga (chunker
  86.  and dechunk for 2.0 and higher, chunker13 and dechunk13 for 1.2 and higher)
  87.  and MSDOS (CHUNKER.EXE and DECHUNK.EXE). The ANSI C source code is included
  88.  in the source drawer. This source should complile with all ANSI C compilers.
  89.  To compile the unix version simply type 'make' in the source directory. The 
  90.  makefile does the following:
  91.  
  92.    CC -O2 -o chunker chunker.c machine.c bfn.c
  93.    CC -O2 -o dechunk dechunk.c machine.c bfn.c
  94.       ### ##########
  95.        |      \
  96.  turns |       \ specifies the name of the compiled program
  97.  on level        to create.
  98.  2 optimisation
  99.  
  100.  
  101.  USAGE
  102. -=====-
  103.  
  104.  Chunker is used to split a file up into smaller pieces. It expects the
  105.  following arguments:
  106.  
  107.    chunker <file> <basename> <size>
  108.  
  109.  file: Name of the file to split.
  110.  
  111.  basename: The created split files will have this as their base name. For
  112.     example if you had "ding" as basename then the created files would
  113.     be:
  114.         ding.000
  115.         ding.001
  116.         :
  117.         :
  118.         ding.XXX
  119.     Note that the XXX part is a 3 part hexadecimal number.
  120.  
  121.  size: Size (in bytes) of the created chunks.
  122.  
  123.  For example:
  124.  
  125.    chunker bigfile.gz bigfile 716800
  126.  
  127.  would split the file 'bigfile.gz' into 700k chunks with a basname of
  128.  'bigfile'.
  129.  
  130.  
  131.  DeChunk will reassemble the chunks output by Chunker into the original
  132.  file. It expects the following arguments:
  133.  
  134.    dechunk <outputfile> <basename>
  135.  
  136.  outputfile: Name of the file to create.
  137.  
  138.  basename: The basename of the split files. For example if the first of the 
  139.     split files is called "ding.000" then use "ding". This should be the
  140.     same as you passed as basename to Chunker.
  141.  
  142.  
  143.  NOTE the Amiga join or Unix cat commands could be used rather than dechunk,
  144.  if you're a masochist that is ;)
  145.  
  146.  NOTE that the amiga 2.0 version accepts arguments in the normal ReadArgs
  147.  format, just type 'chunker ?' and 'dechunk ?' for the template. The
  148.  Amiga versions are also pure and reentrant, and as such can be made
  149.  resident.
  150.  
  151.  
  152.  CONTACT
  153. -=======-
  154.  
  155. Means of contact, as of Tuesday 02 April 1996
  156.  
  157. Mail:
  158.   Lee Kindness
  159.   8 Craigmarn Road
  160.   Portlethen Village
  161.   Aberdeen AB1 4QR
  162.   SCOTLAND
  163.  
  164. EMail:
  165.   cs2lk@scms.rgu.ac.uk
  166.   wangi@frost3.demon.co.uk
  167.   wangi@spuddy.mew.co.uk
  168.   wangi@fido.zetnet.co.uk
  169.   :
  170.   :
  171.   Please use cs2lk@scms.rgu.ac.uk
  172.  
  173. Fidonet:
  174.   2:259/15.46
  175.   2:250/366.34
  176.  
  177. Amiganet:
  178.   39:138/40.34
  179.  
  180. And why not have a look at my web page:
  181.  
  182.   http://www.scms.rgu.ac.uk/students/cs_yr94/lk
  183.  
  184. It has a wide range of Amiga and Fidonet links...
  185.  
  186. The initial concept and code for Chunker was by Evan Tuer. You can email
  187. Evan at alienz@freenet.hut.fi
  188.  
  189.  
  190.  LATEST VERSION
  191. -==============-
  192.  
  193.  The latest version of Chunker can always be found on:
  194.  
  195.        _____
  196.       /_____)
  197.      /(___________________________________
  198.     / _____________  ___________________  )
  199.    / /            / (_                  \/   +44-(0)1484-842341
  200.   (__) r o s t   / ___) r e e
  201. \               / /                         Fidonet --- 2:250/366
  202.  \              \/   A m i g a  B B S       Amiganet -- 39:138/40
  203.   \
  204.    \-> Sysop Dave Naylor
  205.     \-> Using Zeus BBS software!
  206.      \-> The biggest UK Amiga BBS
  207.       \-> Points welcome
  208.        \-> Email!
  209.         \-> 24 hours a day in sunny Yorkshire!
  210.  
  211. And the Chaos Engine BBS, 2:259/15 - 01346-510727
  212.  
  213.  
  214.  Chunker will be in the WANGI file area or you can freq it using the
  215.  magic filename CHUNKER.
  216.  
  217.  
  218.  VERSION HISTORY
  219. -===============-
  220.  
  221. 1.0  : 04.11.95
  222.      + Original version
  223.  
  224. 1.1  : 05.11.95
  225.      + Full documentation added.
  226.  
  227. 1.2  : 10.11.95
  228.      + Added lots of conditional coding... Amiga exe size is now 2.5k
  229.        compared to 12k !!
  230.      + Amiga version now accepts readarg arguments.
  231.      + Chunker and dechunk Amiga versions are now pure, they can
  232.        be made resident.
  233.      + Actually compiled the MSDOS versions... by heck they are
  234.        over 15k in size!
  235.  
  236. 1.2b
  237. 1.3  : 14.11.95
  238.      + Unix compilation would fail. A #endif was missing from version.h
  239.      + Improved and fixed Unix makefile.
  240.  
  241. 1.4  : 18.02.96
  242.      + Massive speed increase with the Amiga version! About 374% faster!!
  243.        Thanks to Asyncio!
  244.  
  245. 1.5  : 20.02.96
  246.      + Chunker and dechunk would crash if run with wb 1.2,1.3. Fixed this
  247.        and the 1.2 compatable Amiga versions are now also included in the
  248.        archive
  249.  
  250. 1.6  : 01.04.96
  251.      + Minor compilation changes.
  252.      + Fixed minor bug in Unix makefile
  253.      + Fixed problem with segmentation fault on Unix if no args are given
  254.        (Thnaks to Oliver Roberts for pointing out the 2 bugs above)
  255.  
  256.  
  257.  OTHER PROGRAMS
  258. -==============-
  259.  
  260. List of programs by Lee Kindness. Note this is only the programs that i have
  261. done, it is not everything i have uploaded to Aminet. The version numbers,
  262. dates and archive sizes given below are, more than likely, out of date as
  263. you read this...
  264.  
  265. FindXXX.lha        comm/fido    9K   5+Comprehensive Nodelist searching utility
  266. FindXXXSrc.lha     comm/fido    9K   5+Source for nodelist searching utility
  267. GFindXXX.lha       comm/fido    9K   5+Comprehensive (Gotcha) Nodelist searchin
  268. GFindXXXSrc.lha    comm/fido    8K   5+Source for (Gotcha) nodelist searching u
  269. GMulti.lha         comm/fido   17K   1+1.0 Gives multiline node support (for po
  270. NLFind.lha         comm/fido   16K   1+1.4 Gives multiline node support (for po
  271. SFPatch.lha        dev/c        8K  36+How to SetFunction()/Patch library funct
  272. Umentiler.lha      dev/misc    28K   1+1.208 Document Compiler (plus SAS/C sour
  273. Jiggler.lha        game/gag     9K  47 Windows move toward mouse pointer.
  274. Acechan.lha        misc/math   11K  32+Makes random spread data??? Pascal sourc
  275. DQua.lha           misc/math   13K  59+1.2 Simple quadratic solver.
  276. MacCash.lha        misc/misc   15K  22+1.3 Gen. UK Lott. Forms. Also stat. Anal
  277. RARS_Ami_2lite.lha misc/sci    55K  41+RARS_Amiga for 020+ and no fpu
  278. DefDTIcon.lha      pix/icon    41K  59+1.7 Default icons, based on files dataty
  279. AmigaGuidePref.lha text/hyper  19K  59+36.144 Preferences for Amigaguide system
  280. RubbDump.lha       util/app   195K  52+V1.1 Replacement trashcan. With sound.
  281. WanDiArc_lsk.lha   util/arc     3K  47 Archive support for WangiPad 1.15
  282. NewEXT.lha         util/batch  10K  57+1.4 Change file extensions.. in batches.
  283. CaBoom.lha         util/boot    9K  22+Windows explode on opening/closing
  284. CaBoomSrc.lha      util/boot    8K  22+Source for CaBoom
  285. SlowBoot18.lha     util/boot    9K  13+1.18 If you HD dosen't boot from cold ge
  286. SlowBootSrc18.lha  util/boot    4K  13+Source for SlowBoot 1.18
  287. Startup-Menu.lha   util/boot  120K  57+V1.41 Cumstomisable startup menu and uti
  288. YourFault.lha      util/boot   20K  32+1.4 Replace system error strings - fun!,
  289. YourFaultSrc.lha   util/boot    6K  32+Source for YourFault 1.4
  290. YourFaultStr.lha   util/boot   17K  32+Error files for YourFault, Standard Loca
  291. Bush.lha           util/cli    10K  59+1.4 Shows directory tree structures.
  292. Erase.lha          util/cli     9K  22+1.1 Deletes a file so that it can't be r
  293. chunker.lha        util/misc   36K  10+1.2b Split+Join files! Ami/MSDOS/Unix (C
  294. DiceRoll.lha       util/misc    6K  53+Emmulates dice throws - generate rand nu
  295. naegrey_101.lha    util/misc    9K  40+Remove grey screen border. WB2+ OS frien
  296. Publican.lha       util/misc   11K  44+Public screen support utility.
  297. MidMoose.lha       util/mouse   3K  32+2.0  Emulates mid mouse button via a key
  298. shrub_114.lha      util/wb     21K  39+V1.14 Shows directory trees, WB GUI.
  299. WangiPad.lha       util/wb     53K  45+1.16 BEST Tool launcher, readme please
  300.  
  301.  
  302. -- Wangi!
  303.  Lee Kindness  cs2lk@scms.rgu.ac.uk wangi@frost3.demon.co.uk
  304.  Team TRUMPET! http://www.scms.rgu.ac.uk/students/cs_yr94/lk
  305.  
  306.